.. _cmsGnSetServoOn:

cmsGnSetServoOn
==================
------------------


SYNOPSYS
`````````````
.. code-block:: none

    VT_I4 cmsGnSetServoOn ([in] VT_I4 BoardId, [in] VT_I4 Axis, [in] VT_I4 dwIsOn)

DESCRIPTION
`````````````  

- cmsGnSetServoOn() 함수는 지정한 채널(축)의 SERVO-ON 신호 출력을 제어합니다. 서보
  드라이버를 사용하실 때는 외부에서 스위치를 이용하여 서보드라이버의 ON/OFF 를 제어할
  수 있도록 하는데, 이를 SERVO-ON 신호의 ON/OFF 를 제어하는 함수입니다.

\

- 이 함수의 사용과 호출에 있어, 제공된 ㈜커미조아의 함수 헤더 Visual Basic 에서는 함수의
  첨두어 cms 가 붙지 않습니다. 

PARAMETER
`````````````

▶ BoardId: 사용자가 설정한 디바이스(보드) ID.

▶ Axis: 채널(축) 번호(0 부터 시작합니다).

▶ dwIsOn: cmsGnSetServoOn 함수의 인자이며, SERVO-ON 신호의 출력 상태를 설정합니다.


.. csv-table::
    :widths: 10 90
    :header-rows: 1
    :stub-columns: 0

    Value, Meaning
    0 또는 cmsFALSE, SERVO-OFF
    1 또는 cmsTRUE, SERVO-ON

RETURN VALUE
`````````````


+------------+-----------+
|    Value   | Meaning   |
+============+===========+
|    음수    | 수행 실패 |
+------------+-----------+
| ERR_NONE   | 수행 성공 |
+------------+-----------+

REFERENCE
```````````

- 서보를 On 시켜야 하는 경우 cmsGnLoadDeivce () 함수 호출 이후에 cmsGnSetServoOn
 (Device#, Axis#, cmsTRUE)를 호출해 주셔야 서보 모터가 정상 동작 합니다.